Public Function move_quote(ByVal quote_id As String, _

                           ByVal new_wipbin As String) As Integer

Description

This API causes the specified quote to be moved from one WIPBin to another WIPBin. The new WIPBin must belong to the same user as the first WIPBin. The move operation does not change the ownership of the quote, nor is an activity log or time bomb generated for the action.

Note: This API allows you to move a queueable quote from one WIPBin to another, even if the quote is currently dispatched. Since WIPBins are internal to a user, there really is no reason that you shouldn't be able to move the interal (to a user) location of the quote. This is an enhancement to base Clarify function, which requires that the quote not be dispatched to be moved.

Parameters

Parameter Name                Required?             Description                                                                                                          

quote_id                                                Yes                         The quote to move

new_wipbin                          Yes                         The WIPBin to move the quote to. If left blank, the quote is moved to the                                                                               user's default WIPBin

Returns     

Value                                     Meaning                                                                                                                                               

0                                              No errors

-1                                             Cannot find the specified quote

-2                                             Quote is already closed

-3                                             New WIPBIN doesn't exist, or isn't for the owner

-4                                             New WIPBIN is same as old - no move needed

Examples  

·         Move quote number '154' to the default WIPBin for the current owner.

JavaScript:

var ret_int = fc_cc.move_quote("154", "")

Visual Basic:

Dim ret_int As Integer

ret_int = fc_cc.move_quote("154", "")

·         Move quote number 'Q2' to WIPBin 'Urgent'.

JavaScript:

var ret_int = fc_cc.move_quote("Q2", "Urgent")

Visual Basic:

Dim ret_int As Integer

ret_int = fc_cc.move_quote("Q2", "Urgent")